home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / handy11.zip / USERON.SUP < prev    next >
Text File  |  1992-05-07  |  3KB  |  111 lines
  1.  
  2.                            -=( The UserDoes idea )=-
  3.  
  4.  
  5. This is a little documentationfile about the UserDoes and the SysDoes files
  6. used by my UserOn door and by HandyMan.
  7.  
  8.  
  9. History and Why??
  10. =================
  11.  
  12. The idea for the UserOn door was born after RA threw in the status field
  13. for the "Who's online" menu type. Users on the other lines could see what
  14. the other users were doing.. or.. could they? Well, actualy, as long as
  15. the other user stayed in RA, everything wasn't to bad.. But when the
  16. uses started a door, RA was only telling that the user was "External"
  17. Who cares..
  18.  
  19. So I dreamed up UserOn. Every door can post information for UserOn to
  20. display. If the door doesn't do it, the SysOp can do it himself from
  21. batch. So there's no longer any excuse for just "External"....
  22.  
  23.  
  24. UserDoes:
  25. =========
  26.  
  27. UserDoes.<Node> is the info file created by the door. It's a textfile with
  28. a single line of text of max. 75 characters.
  29.  
  30. The extention of the UserDoes file is the node of the program who created the
  31. UserDoes file.
  32.  
  33. So USERDOES.1 is a legal name. (USERDOES.001 is NOT!)
  34.  
  35. This UserDoes file can contain a simple line like:
  36.  
  37.   Is playing multi-line tradewars 3001.. Return of the klingons!
  38.  
  39. Or can be continualesly be updated to show the users score.
  40.  
  41.  F.e.
  42.  
  43.   Is playing Tetra. Score 100 Lines 35
  44.  
  45.  
  46. it is the responsibilty of the door or batchfile to clean up its own
  47. mess and delete the UserDoes again.
  48.  
  49.  
  50.  
  51. SysDoes:
  52. ========
  53.  
  54. Ok, the UserDoes tells the world what the users are doing, but what if
  55. the system is processing mail.. And you want to tell the world why everyting
  56. is so slow.. SysDoes is a file shown in UserOn (and HandyMan) when there's
  57. no user on line. You can use it for occasions like thisone, or to tell
  58. everybody that Line 3 is just a local line waiting for the sysop.
  59.  
  60. Example:
  61.  Let's say that Node 1 is processing mail and node 3 is a local node.
  62.  
  63.  Create a SysDoes.3 with the line:
  64.  
  65.    * Local node, just waiting for the SysOp *
  66.  
  67.  and put it into your semafore directory. From that point on, whenever you're
  68.  not logged on to node 3, this line is shown in UserOn. It's never deleted
  69.  unless you delete it yourself..
  70.  
  71.  At the beginning of your incomming mail batch you write a line:
  72.  
  73.    Echo Node is processing mail. > G:\SEMAFORE\SYSDOES.1
  74.  
  75.  and at the end of the mailbatch
  76.  
  77.    Del G:\SEMAFORE\SYSDOES.1
  78.  
  79. And everybody who logs on to the other lines can see why node one is down.
  80.  
  81.  
  82.  
  83. Tech info:
  84.  
  85.  ■ SYSDOES and USERDOES files are posted through the SEMAFORE directory.
  86.    (The semaforepath in the RAConfig)
  87.  
  88.  ■ SYSDOES is never deleted. It's overruled by a user logging in. Or
  89.    you have to delete it yourself.
  90.  
  91.  ■ USERDOES is created when nessecary and it's the creators responsibility
  92.    to clean up!
  93.  
  94.  ■ Both the SysDoes and the UserDoes can contain a single line of ascii
  95.    text. Maximal length 75 printable characters. Don't put ansi or avatar
  96.    codes in those strings..
  97.  
  98.  
  99. Doors supporting UserDoes files:
  100.  
  101.  ■ All the LiveSystems Doors and the RADoor door writers toolbox.
  102.     (Pong, Trivia, UserOn itself, News, ShowFile, Vote, etc.)
  103.  
  104.  ■ Richard Faasen's Tetra and his toolbox RADU
  105.  
  106.  ■ Jos Bergman's RAStock
  107.  
  108.  ■ Ron Huiskes RA_New, RA_Files and his toolbox.
  109.  
  110.  
  111.